home *** CD-ROM | disk | FTP | other *** search
/ Nothing but GIFs AGA / Nothing But GIFs.iso / utility / pc-dos / iv1_02a.arj / IV.DOC < prev    next >
Text File  |  1994-01-08  |  17KB  |  375 lines
  1.                                 imgTECH/IV
  2.  
  3.  
  4. This document contains a brief introduction to the imgTECH/IV image
  5. viewer.  The following topics will  be considered:
  6. 1.  What is imgTECH/IV and what is it useful for?
  7. 2.  What are the hardware requirements?
  8. 3.  What capabilities does it have?
  9. 4.  What limitations does it have?
  10. 5.  Installation
  11. 6.  Using imgTECH/IV
  12.  
  13.      
  14. 1. What is imgTECH/IV?
  15.  
  16. imgTECH/IV is an image viewer.  That is, it can read digitized pictures,
  17. display them and manipulate them in various ways.  A person may wish to
  18. do this for one of several reasons:
  19.  
  20.  
  21. 2. Hardware requirements
  22.  
  23.   a)  386SX or higher CPU 
  24.   b)  At least one megabyte of memory
  25.   c)  A hard disk with at least two megabytes free
  26.   d)  A mouse
  27.  
  28.  
  29. 3. imgTECH/IV capabilities
  30.  
  31.   a)  IV is a 32 bit program.  As such it requires a 386 or higher CPU.  Since
  32.       displaying an image require a lot of memory, IV will use all extended
  33.       memory installed in the computer and will then use the hard disk as
  34.       virtual memory.  IV requires a VGA system, and operates it in 256
  35.       color mode with one of the following resolutions:
  36.       1.  640x480x256
  37.       2.  800x600x256
  38.       3.  1024x768x256
  39.     
  40.   b)  IV allows multiple images to be loaded in memory and displayed in the
  41.       screen at once.  Images may be of arbitrary size.  If the image is larger
  42.       than the screen resolution (ie. an 800x600 pixel image and a 640x480
  43.       pixel screen) the image will be clipped to fit the screen.  The image
  44.       may be scrolled using the CTRL+ARROW keys.
  45.  
  46.   c)  IV can read and write images in the following formats: IV native
  47.       format (faster), BMP, PCX, JPG, TIFF, GIF and ASCII.  An ascii
  48.       image is a text file in the following format:
  49.       Line 1:                # of rows
  50.       Line 2:                # of columns
  51.       Line 3 -> 3+rows:      pixel values of that row
  52.  
  53.   d)  IV supports image stacks.  An image stack is an image file that
  54.       contains a number of individual images.  An image stack may
  55.       represent:
  56.       1.  A time series.  That is, a series of pictures of an object taken at
  57.           different times.
  58.       2.  The third spatial dimension.  Images are two dimensional, but an
  59.           image stack may be a series of pictures taken at various depths.
  60.       3.  A number of images that are somehow related, and stored together
  61.           for convenience.  For example, a number of images may be stored
  62.           together and shown in sequence creating a slide show.
  63.       4.  A totally unrelated set of images.
  64.  
  65.   e)  IV supports the following general kinds of images:
  66.       1.  Grey scale images.  Each pixel in the image represents light
  67.           intensity at that point in the image.  No palette is stored with the
  68.           image.  The image is shown with a grey scale palette (the IV
  69.           default).  These images may be 8 bit (0<=pixel value<=255) or 16
  70.           bit (0<=pixel value<=65536).
  71.       2.  Color images.  Each pixel in the image represents an index into a
  72.           color palette (usually 256 colors) stored with the image.  IV will
  73.           load the image's palette whenever the image is shown.  Since IV can
  74.           show many different images at once, and since the VGA mode used
  75.           by IV is restricted to only 256 different colors, when one color
  76.           image is displayed, other color images already on the screen may
  77.           end up looking strange because a different palette is loaded. 
  78.           NOTE: displaying a 256 color image may change the colors IV uses
  79.           for menus and dialog boxes...  This is because there are no more
  80.           colors left for IV to use.
  81.       3.  24 bit color images are currently not supported.  JPEG images are
  82.           converted to 8 bit color images.
  83.  
  84.   f)  IV provides the following functions:
  85.       1.    scale -- scale an image up or down.  X and Y may have different
  86.             scale factors.  The scale factor is determined by specifying the
  87.             numerator and denominator.  For example, to scale an image by
  88.             1.5 in the X direction and 0.67 in Y the Y direction:
  89.             X: numerator = 3  denominator = 2    3/2=1.5
  90.             Y: numerator = 2  denominator = 3    2/3=0.67
  91.       2.    rotate -- rotate an image by 90, 180 or 270 degrees.
  92.       3.    mirror -- create a mirror image.
  93.       4.    zoom -- zoom in on a small part of an image.
  94.       5.    greyscale -- convert a color image into a grey scale image.  The
  95.             red, green and blue components of each color in the image's
  96.             palette are used to find a grey scale intensity for that color.
  97.       6.    movie -- display each image in an image stack in rapid succession. 
  98.             Creating a movie or slide show effect.  Note: the number of
  99.             frames per second displayed depends on the size of the image.
  100.       7.    tile -- display a number of images in an image stack at once.
  101.       8.    insert -- insert an image into an image stack.
  102.       9.    delete -- delete an image from an image stack.
  103.       10.   split -- split up an image stack into a number of single images.
  104.       11.   cut -- cut a portion of an image out, creating a new image.
  105.       12.   paste -- paste one image into another.
  106.       13.   undo/redo
  107.  
  108.   g)  IV has hypertext help.
  109.  
  110.   h)  The IV interface features drop down menus and a command line.
  111.  
  112.   i)  All IV functions are available from macros.  IV can create macros by
  113.       recording a series of key strokes.  Macros are stored in ascii text files
  114.       so that they may be later edited and refined as necessary.  Macros also
  115.       support looping and if-then constructs.
  116.  
  117.   k)  IV has a full screen mode in which an image is displayed on the screen
  118.       by itself without any menus etc.  This is a useful mode for creating
  119.       slide shows.
  120.  
  121.   l)  Gamma correction.
  122.  
  123.  
  124. 4. imgTECH/IV limitations
  125.  
  126.   a)  No 24 bit color images.
  127.   b)  Doesn't use 32K, 64K color, 24 bit VESA modes when available.
  128.   c)  Doesn't support, or even run, under Windows, OS2 or Deskview.
  129.   d)  Doesn't read compressed TIFF images.
  130.   e)  Cannot print images.  Images must be imported into a word processor
  131.       or desktop publisher to be printed.
  132.   f)  Doesn't support image editing (drawing lines, adding text etc.)
  133.  
  134.  
  135. 5. Installing imgTECH/IV
  136.  
  137.   a)  Place the installation disk in drive A:
  138.   b)  Type a:
  139.   c)  Type install
  140.   d)  Install will examine the video system, if it is recognized, install will
  141.       ask for confirmation.  If install doesn't recognize the video system or is
  142.       incorrect, you may select a driver from the list presented.
  143.   e)  When installation is complete, IV may be started by typing iv from the
  144.       dos command line.  Note: IV requires the CPU to be in real mode. 
  145.       Programs like Windows and some EMS emulators put the CPU in
  146.       Virtual 86 (V86) mode, and are thus incompatible with IV.  If you are
  147.       using an EMS emulator like EMM386.SYS make sure that EMS is not
  148.       disabled (ie. EMM386.SYS is NOT run with the NOEMS parameter).
  149.   IV can also install from a hard disk if so desired.
  150.  
  151.   Whenever the configuration of the computer is changed, such as changing
  152.   video cards, adding a math coprocessor or changing path names, run the
  153.   program ivconfig.  This will tell IV about the changes.
  154.  
  155.   IV may be started from any directory, as long as the file iv.cfg is located
  156.   in a directory named in the path statement.  iv.cfg is created by
  157.   ivconfig.
  158.  
  159.  
  160. 6. Using imgTECH/IV
  161.  
  162.   When IV starts, it will show a message indicating the program's serial
  163.   number and the person to whom the program is registered.  Press any key
  164.   to get past this message.
  165.  
  166. a)  Using the menus
  167.     Clicking on a menu title, or pressing ALT+The highlighted letter in the
  168.     menu name will cause the menu to drop down.  Use the arrow keys to
  169.     move the scroll bar from item to item, or else click (using the left mouse
  170.     button) on the desired item.  Pressing ENTER or pressing the right
  171.     mouse button (always equivalent to pressing ENTER) will select the
  172.     item.  Alternatively, double clicking (with the left mouse button) on an
  173.     item will select it.  Many functions will require further input.  In these
  174.     cases, IV will prompt for whatever information is still required.
  175.  
  176. b)  Using the command line
  177.     All IV functions are available from the command line.  This is a faster
  178.     interface for people familiar with IV.  The command line syntax is
  179.     described below.  NOTE: items in square brackets are optional, a bar |
  180.     separates items where either one or the other may be used.  If optional
  181.     items are not given on the command line, IV will prompt for them. 
  182.     Commands may be abbreviated by the first two letters in the command.
  183.  
  184.       open            [files]
  185.       save            [[pal kern filt [as image file]] images] 
  186.       close           [[all] [images]]
  187.       run             [commandline]
  188.       shell
  189.       quit
  190.       show            [[all] [images]]
  191.       erase           [[all] [images]]
  192.       scale           [xmul xdiv ymul ydiv [images]] or [image]
  193.       rotate          [angle [images]] or [image]
  194.       mirror          [images]
  195.       greyscale       [images]
  196.       paste           [image1 image2 [x y [op]]]
  197.       cut             [image [x1 y1 x2 y2]]
  198.       stats           [image [x1 y1 x2 y2]]
  199.       movie           [images]
  200.       tile            [images]
  201.       insert          [image1 [image2 [image_number]]
  202.       delete          [image [image_number]]
  203.       split           [images]
  204.       execute         [file]
  205.       record          [file]
  206.       ascii           [images]
  207.       abox            [images]
  208.       aline           [image [file [x1 y1 x2 y2]]]
  209.       set             [stack|backup|coordinates|keywait|delay#|continuous
  210.                       |playbackward|fullscreen|gamma #|quality #|directory|
  211.                       dir]
  212.       unset           [stack|backup|coordinates|keywait|delay #|
  213.                       continuous|playbackward|fullscreen]
  214.       convert         [image [bmp|pcx|jpg|gif|tiff|ascii]]
  215.       fullscreen
  216.       unfullscreen
  217.       zoom            [image [x1 y1 x2 y2]]
  218.       pal             [image]                  (load palette of given image)
  219.       goto            [+#|-#|# [images]]       (go to given image in stack)
  220.       next            [images]                 (go to next image in stack)
  221.       previous        [images]                 (go to previous image in stack)
  222.  
  223. c)  Using macros
  224.     Macros are ascii text files containing a list of commands to be executed
  225.     by imgTECH/IV.  Macros may be created by one of two ways:
  226.  
  227.     1. Macros may be created by recording a series of keystrokes and then
  228.        simply playing them back.
  229.  
  230.     2. Macros be created using a text editor.  This allows full use of the
  231.        imgTECH/IV macro language.  The syntax of which is described
  232.        below:
  233.  
  234.        a.   Variables may be of either numeric type or string type.  String
  235.             variables must be preceded by a dollar sign ($) to indicate to IV
  236.             that the variable is of string type.
  237.  
  238.             For example:
  239.             x=10
  240.             $i="imgTECH/IV"
  241.  
  242.        b.   A block of commands may executed a number of times.  Looping
  243.             is provided as follows:  The loop is initiated by a loop statement
  244.             which indicates how many times the loop is to be repeated.  A
  245.             number or a numeric variable may be used for this purpose.  The
  246.             loop is terminated by a pool statement (loop spelled backwards).
  247.             
  248.             For example:
  249.             loop x
  250.               :
  251.             pool
  252.  
  253.        c.   A block of commands may be conditionally executed, or not as
  254.             follows:  An if statement containing a condition, initiates the
  255.             block.  The block is terminated by a fi statement.  The condition
  256.             has the form: if (number or variable)<=>(number or
  257.             variable).  If the condition is true, the block of commands will
  258.             be executed, otherwise they will not.  The else structure provides
  259.             an alternative block of commands to execute if the condition is
  260.             false.
  261.  
  262.             For example:
  263.             if x=10
  264.               :
  265.             else
  266.               :
  267.             fi
  268.             -----
  269.             if $i != "imgTECH/IV"
  270.               :
  271.             fi
  272.  
  273.        d.   Macro execution is terminated by an end statement.
  274.  
  275.        e.   The following commands are provided for interactive operation:
  276.             1)  echo "message to screen"
  277.                 Echos a message to the screen.  The message remains there
  278.                 until it is unechoed.
  279.             2)  unecho
  280.                 Unechoes an echoed message.
  281.             3)  ask $string_variable "prompt"
  282.                 Prompts the user for a line of input, and stores the line in
  283.                 $string_variable.
  284.             4)  getkey
  285.                 Halts execution until a key is pressed.
  286.             5)  sleep #
  287.                 Halts execution for # seconds.  # may be a number or a
  288.                 numeric variable.
  289.             6)  Any command available from the IV command line may be
  290.                 used in a macro.
  291.                   
  292. d)  Using image stacks
  293.     There are a number of things to be aware of when working with image
  294.     stacks:
  295.     1. All images in a stack have the same dimensions.  IV will clip images
  296.        as necessary to enforce this requirement.
  297.     2. Processing, by default occurs only on one image per stack (the image
  298.        stored in memory -- all others are stored on disk -- thus greatly
  299.        speeding up processing).  However, an option may be set so that
  300.        processing occurs on all images in the stack (menu:
  301.        OPTIONS/PROCESSING/STACK or command line: set|unset
  302.        stack).
  303.     3. Each image in a stack of color images may have a different palette.
  304.     4. PGUP and PGDN will scroll through the stack.
  305.  
  306. e)  Using help
  307.     To get help, press F1.  The arrow keys and PGUP and PGDN scroll
  308.     through the help.  Clicking (with the left mouse button) on a highlighted
  309.     item (normally displayed in blue) will cause the help system to display
  310.     information on that item.  Pressing ESC causes the help window to close.
  311.  
  312. f)  IV hotkeys
  313.     1. ESC:
  314.        a)   cancels help.
  315.        b)   aborts processing.
  316.        c)   aborts a menu or dialog box.
  317.        d)   interrupts macro execution.
  318.        e)   closes an option window.
  319.     2. F1: opens help window.
  320.     3. PGUP/PGDN: scrolls through an image stack.
  321.     4. F2: toggles between full screen mode and non full screen mode.
  322.     5. ALT+U: undo.  redo is achieved by undoing and undo.  Note: this
  323.        only applies when backup is off (menu:
  324.        OPTIONS/PROCESSING/BACKUP of command line: set|unset
  325.        backup)
  326.     6. ALT+X: quits IV.
  327.       
  328. g)  IV options
  329.     OPTIONS/PROCESSING
  330.     1. Operate on image stacks (y or n).  By default (for speed) processing
  331.        only occurs on the image in the stack that is currently displayed (ie
  332.        stored in memory).  Set this option to 'y' to cause IV to operate on
  333.        every image in the stack.
  334.     2. Maintain backups (y or n).  By default IV creates a new image every
  335.        time it performs an image processing function.  This can rapidly fill
  336.        up memory.  Setting this option to 'n' will cause IV to discard the
  337.        original image after it has been processed.  Any operation may then
  338.        be undone with ALT+U.  Redo is accomplished by undoing an undo.
  339.  
  340.     OPTIONS/MOVIE
  341.     1. Wait for keystroke (y or n).  IV will wait for a keystroke between
  342.        every frame in the movie.
  343.     2. Delay (in ms).  Specify a delay to be inserted between every frame.
  344.     3. Play backwards (y or n).  Play the movie backwards.
  345.     4. Continuous play (y or n).  The movie will play over and over until
  346.        ESC is pressed.
  347.     5. Full Screen (y or n).  Show the movie in full screen mode (nothing but
  348.        the image on the screen).
  349.  
  350.     OPTIONS/OTHER
  351.     1. Show Coordinates (y or n).  By default, when the mouse is positioned
  352.        on an image, the coordinates and pixel intensity is displayed in the
  353.        upper right hand corner of the screen.  This may be turned off.
  354.  
  355.     2. Show Palette Bar (y or n).  By default the currently loaded palette is
  356.        displayed in the upper right hand corner of the screen.  This may be
  357.        turned off.
  358.  
  359.     3. Gamma correction.  Gamma determines the way color contrast is
  360.        displayed.  Changing gamma changes the contrast.  The default value
  361.        is 1.
  362.  
  363.     4. JPEG quality.  JPEG is a lossy format (ie. some information is lost). 
  364.        The quality factor, ranging between zero and one hundred, determines
  365.        how much information is lost.  It also determines the compression
  366.        ratio (the lower the quality factor, the higher the compression ratio). 
  367.        By default, the quality factor is set to 75.
  368.  
  369.     OPTIONS/DIRECTORY
  370.     This option specifies the directory in which IV looks for it's data files.
  371.  
  372.     OPTIONS/SAVE
  373.     The current option settings may be saved in a file called iv.rc from
  374.     which they will be reloaded the next time IV starts.
  375.